home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat5 / pam_test.z.z / pam_test.z
Encoding:
Text File  |  2003-11-18  |  2.9 KB  |  90 lines
  1. .\" Sccs id goes here
  2. '\"macro stdmacro
  3. .\" Copyright (c) 1995, Sun Microsystems, Inc. 
  4. .\" All Rights Reserved
  5. .nr X
  6. .TH pam_test 5 "19 October 1995"
  7. .SH NAME
  8. pam_test \- authentication management functions for testing PAM
  9. .SH SYNOPSIS
  10. .LP
  11. .B /usr/lib/security/pam_test.so
  12. .P
  13. .LP
  14. .SH DESCRIPTION
  15. .IX "pam_test" "" "\fLpam_test\fP \(em authentication management for testing PAM"
  16. .PP
  17. The TEST service module for PAM is divided 
  18. into four components: The
  19. .I authentication, account management, password management,
  20. and
  21. .I session management.
  22. The test is a shared object that is dynamically loaded to provide
  23. the necessary functionality.
  24. .SH TEST Authentication Component
  25. The TEST authentication module, typically
  26. .I /usr/lib/security/pam_test.so,
  27. provides functions to test the PAM framework functionality using the
  28. .B pam_sm_authenticate(3)
  29. call.
  30. The TEST module implementation of the
  31. .B pam_sm_authenticate(3) 
  32. function compares the user entered password with the password set in the
  33. .BR pam.conf(4)
  34. file, or the string "test" if a default test password has not been set.
  35. The following options may be passed in to the TEST Authentication module:
  36. .RS
  37. .IP debug 15
  38. Syslog debugging information at the LOG_DEBUG level.
  39. .IP passwd=foobar 15
  40. Sets the password to be "foobar".
  41. .IP first_pass_good 15
  42. The first password is always good when used with the use_first_pass or 
  43. try_first_pass option.
  44. .IP first_pass_bad 15
  45. The first password is always bad when used with the use_first_pass or 
  46. try_first_pass option.
  47. .IP always_fail 15
  48. Always returns PAM_AUTH_ERR.
  49. .IP always_succeed 15
  50. Always returns PAM_SUCCESS.
  51. .IP always_ignore 15
  52. Always returns PAM_IGNORE.
  53. .IP use_first_pass 15
  54. Use the user's  initial password (entered when the user is authenticated to the
  55. first authentication module in the stack) to authenticate with the TEST module.
  56. If the passwords do not match, or if this is the first authentication module in the 
  57. stack, quit and do not prompt the user for a password. It is
  58. recommended that this option only be used if the TEST authentication 
  59. module is designated as
  60. .I optional
  61. in the
  62. .B pam.conf
  63. configuration file. 
  64. .IP try_first_pass 15
  65. Use the user's  initial password (entered when the user is authenticated to the
  66. first authentication module in the stack) to authenticate with the TEST module.
  67. If the passwords do not match, or if this is the first authentication module 
  68. in the stack, prompt the user for a password. 
  69. .RE
  70. .PP
  71. The TEST module
  72. .B pam_sm_setcred(3) 
  73. function always returns PAM_SUCCESS.
  74. .SH TEST Account Management Component
  75. The TEST Account Management Component 
  76. .B (pam_sm_acct_mgmt(3))
  77. always returns PAM_SUCCESS.
  78. .SH TEST Password Management Component
  79. The TEST Password Management Component function
  80. .B (pam_sm_chauthtok(3)),
  81. always returns PAM_SUCCESS.
  82. .SH TEST Session Management Component
  83. The TEST Session Management Component functions
  84. .B (pam_sm_open_session(3),
  85. .B pam_sm_close_session(3))
  86. always return PAM_SUCCESS.
  87. .SH "SEE ALSO"
  88. .BR pam (3),
  89. .BR pam.conf (4)
  90.